为了账号安全,请及时绑定邮箱和手机立即绑定

在Android 设备上获取照片、裁剪图片、压缩图片

标签:
Android

原文链接:http://www.apkbus.com/blog-705730-61863.html

TakePhoto 简介

TakePhoto是一款用于在Android设备上获取照片(拍照或从相册、文件中选择)、裁剪图片、压缩图片的开源工具库,目前最新版本3.0.0
3.0以下版本及API说明,详见TakePhoto2.0+

V3.0

·         支持通过相机拍照获取图片

·         支持从相册选择图片

·         支持从文件选择图片

·         支持批量图片选取

·         支持图片压缩以及批量图片压缩

·         支持图片裁切以及批量图片裁切

·         支持照片旋转角度自动纠正

·         支持自动权限管理(无需关心SD卡及摄像头权限等问题)

·         支持对裁剪及压缩参数个性化配置

·         提供自带裁剪工具(可选)

·         支持智能选取及裁剪异常处理

·         支持因拍照Activity被回收后的自动恢复

·         支持Android7.0

GitHub地址: https://github.com/crazycodeboy/TakePhoto

目录

·         安装说明

·         演示

·         使用说明

·         API

·         贡献

安装说明

Gradle:

[代码]xml代码:

?

1

compile   'com.jph.takephoto:takephoto_library:3.0.0'



Maven:

[代码]xml代码:

?

1

2

3

4

5

6

<dependency>

  <groupId>com.jph.takephoto</groupId>

  <artifactId>takephoto_library</artifactId>

  <version>3.0.0</version>

  <type>pom</type>

</dependency>



使用说明

使用TakePhoto有以下两种方式:

方式一:通过继承的方式
1. 继承TakePhotoActivityTakePhotoFragmentActivityTakePhotoFragment三者之一。
2. 通过getTakePhoto()获取TakePhoto实例进行相关操作。
3. 重写以下方法获取结果

[代码]java代码:

?

1

2

3

void takeSuccess(TResult result);

void takeFail(TResult result,String msg);

void takeCancel();

 

此方式使用简单,满足的大部分的使用需求,具体使用详见simple。如果通过继承的方式无法满足实际项目的使用,可以通过下面介绍的方式。

方式二:通过组装的方式

可参照:TakePhotoActivity,以下为主要步骤:

1.实现TakePhoto.TakeResultListener,InvokeListener接口。

2.在 onCreate,onActivityResult,onSaveInstanceState方法中调用TakePhoto对用的方法。

3.重写onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults),添加如下代码。

[代码]java代码:

?

1

2

3

4

5

6

7

@Override

  public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {

      super.onRequestPermissionsResult(requestCode,   permissions, grantResults);

      //以下代码为处理Android6.0、7.0动态权限所需

      TPermissionType   type=PermissionManager.onRequestPermissionsResult(requestCode,permissions,grantResults);

      PermissionManager.handlePermissionsResult(this,type,invokeParam,this);

  }

 

4.重写TPermissionType invoke(InvokeParam invokeParam)方法,添加如下代码:

[代码]java代码:

?

1

2

3

4

5

6

7

8

@Override

   public TPermissionType invoke(InvokeParam   invokeParam) {

       TPermissionType   type=PermissionManager.checkPermission(TContextWrap.of(this),invokeParam.getMethod());

       if(TPermissionType.WAIT.equals(type)){

           this.invokeParam=invokeParam;

       }

       return type;

   }

 

5.添加如下代码获取TakePhoto实例:

[代码]java代码:

?

01

02

03

04

05

06

07

08

09

10

/**

  *  获取TakePhoto实例

  * @return

  */

 public TakePhoto getTakePhoto(){

     if (takePhoto==null){

         takePhoto=   (TakePhoto) TakePhotoInvocationHandler.of(this).bind(new TakePhotoImpl(this,this));

     }

     return takePhoto;

 }

 

API

获取图片

TakePhoto提供拍照,从相册选择,从文件中选择三种方式获取图片。

API:

[代码]java代码:

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

/**

 * 从文件中获取图片(不裁剪)

 */

void onPickFromDocuments();

/**

 * 从相册中获取图片(不裁剪)

 */

void onPickFromGallery();

/**

 * 从相机获取图片(不裁剪)

 * @param outPutUri 图片保存的路径

 */

void onPickFromCapture(Uri outPutUri);

/**

 * 图片多选

 * @param limit 最多选择图片张数的限制

 **/

void onPickMultiple(int limit);

 

以上三种方式均提供对应的裁剪API,详见:裁剪图片。 
注:
由于不同Android Rom厂商对系统有不同程度的定制,有可能导致某种选择图片的方式不支持,所以为了提高TakePhoto的兼容性,当某种选的图片的方式不支持时,TakePhoto会自动切换成使用另一种选择图片的方式进行图片选择。

裁剪图片

API

TakePhoto支持对图片进行裁剪,无论是拍照的照片,还是从相册、文件中选择的图片。你只需要调用TakePhoto的相应方法即可:

[代码]java代码:

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

/**

 * 从相机获取图片并裁剪

 * @param outPutUri 图片裁剪之后保存的路径

 * @param options 裁剪配置              

 */

void onPickFromCaptureWithCrop(Uri outPutUri, CropOptions options);

/**

 * 从相册中获取图片并裁剪

 * @param outPutUri 图片裁剪之后保存的路径

 * @param options 裁剪配置

 */

void onPickFromGalleryWithCrop(Uri outPutUri, CropOptions options);

/**

 * 从文件中获取图片并裁剪

 * @param outPutUri 图片裁剪之后保存的路径

 * @param options 裁剪配置

 */

void onPickFromDocumentsWithCrop(Uri outPutUri, CropOptions options);

/**

 * 图片多选,并裁切

 * @param limit 最多选择图片张数的限制

 * @param options  裁剪配置

 * */

void onPickMultipleWithCrop(int limit, CropOptions options);

 

#### 对指定图片进行裁剪 
另外,TakePhoto也支持你对指定图片进行裁剪:

[代码]java代码:

?

01

02

03

04

05

06

07

08

09

10

11

12

13

/**

 * 裁剪图片

 * @param imageUri 要裁剪的图片

 * @param outPutUri 图片裁剪之后保存的路径

 * @param options 裁剪配置

 */

void onCrop(Uri imageUri, Uri outPutUri, CropOptions options)throws TException;

/**

 * 裁剪多张图片

 * @param multipleCrop 要裁切的图片的路径以及输出路径

 * @param options 裁剪配置

 */

void onCrop(MultipleCrop multipleCrop, CropOptions options)throws TException;

 

CropOptions

CropOptions是用于裁剪的配置类,通过它你可以对图片的裁剪比例,最大输出大小,以及是否使用TakePhoto自带的裁剪工具进行裁剪等,进行个性化配置。

Usage:

[代码]java代码:

?

1

2

3

4

CropOptions cropOptions=new CropOptions.Builder().setAspectX(1).setAspectY(1).setWithOwnCrop(true).create();   

getTakePhoto().onPickFromDocumentsWithCrop(imageUri,cropOptions);   

//或 

getTakePhoto().onCrop(imageUri,outPutUri,cropOptions);



注:
由于不同Android Rom厂商对系统有不同程度的定制,有可能系统中没有自带或第三方的裁剪工具,所以为了提高TakePhoto的兼容性,当系统中没有自带或第三方裁剪工具时,TakePhoto会自动切换到使用TakePhoto自带的裁剪工具进行裁剪。

压缩图片

你可以选择是否对图片进行压缩处理,你只需要告诉它你是否要启用压缩功能以及CompressConfig即可。

API

[代码]java代码:

?

1

2

3

4

5

6

7

/**

 * 启用图片压缩

 * @param config 压缩图片配置

 * @param showCompressDialog 压缩时是否显示进度对话框

 * @return

 */

void onEnableCompress(CompressConfig config,boolean showCompressDialog);

 

Usage:

[代码]java代码:

?

1

2

3

TakePhoto takePhoto=getTakePhoto();

takePhoto.onEnableCompress(compressConfig,true);

takePhoto.onPickFromGallery();



如果你启用了图片压缩,TakePhoto会使用CompressImage对图片进行压缩处理,CompressImage目前支持对图片的尺寸以及图片的质量进行压缩。默认情况下,CompressImage开启了尺寸与质量双重压缩。

对指定图片进行压缩

另外,你也可以对指定图片进行压缩: 
Usage:

[代码]java代码:

?

01

02

03

04

05

06

07

08

09

10

new CompressImageImpl(compressConfig,result.getImages(), new CompressImage.CompressListener() {

    @Override

    public void onCompressSuccess(ArrayList<timage> images) {

        //图片压缩成功

    }

    @Override

    public void onCompressFailed(ArrayList<timage> images, String msg) {

        //图片压缩失败

    }

}).compress();</timage></timage>



CompressConfig

CompressConfig是用于图片压缩的配置类,你可以通过CompressConfig.Builder对图片压缩后的尺寸以及质量进行相关设置。如果你想改变压缩的方式可以通过CompressConfig.Builder进行相关设置。 
Usage:

[代码]java代码:

?

1

CompressConfig compressConfig=new CompressConfig.Builder().setMaxSize(50*1024).setMaxPixel(800).create();



兼容性

Android6.0

由于Android6.0新增了”运行时权限控制(Runtime Permissions)”,为了应对这一改变,TakePhoto加入和自动权限管理,当TakePhoto检测到需要权限时,TakePhoto会自动申请权限,所以小伙伴们不用担心权限的使用问题。

Android7.0

在Android N中,Android 框架执行了 StrictMode,应用间共享文件和以前也有所区别。为了适配Android7.0的改变,同时也为了方便大家使用TakePhoto,TakePhoto会自动根据手机的Android版本自行适配,小伙伴们依旧可以向TakePhoto传递Uri imageUri = Uri.fromFile(file);类型的Uri而不用担心兼容性问题。

TakePhoto在深度兼容性方面的测试获取更高的兼容性

TakePhoto是基于Android官方标准API编写的,适配了目前市场上主流的Rom。如果你在使用过程中发现了适配问题,可以提交Issues。 
1. 为适配部分手机拍照时会回收ActivityTakePhotoonSaveInstanceState与 onCreate做了相应的恢复处理。
2. 为适配部分手机拍照或从相册选择图片时屏幕方向会发生转变,从而导致拍照失败的问题,可以在AndroidManifest.xml中对使用了TakePhotoActivity添加android:configChanges=”orientation|keyboardHidden|screenSize”配置。
eg:

[代码]xml代码:

?

01

02

03

04

05

06

07

08

09

10

<activity

    android:name=".MainActivity"

    android:screenOrientation="portrait"

    android:configChanges="orientation|keyboardHidden|screenSize"

    android:label="@string/app_name" >

    <intent-filter>

        <action android:name="android.intent.action.MAIN" />

        <category android:name="android.intent.category.LAUNCHER" />

    </intent-filter>

</activity>

 

贡献

如果你在使用TakePhoto中遇到任何问题可以提Issues出来。另外欢迎大家为TakePhoto贡献智慧,欢迎大家Fork and Pull requests


点击查看更多内容
TA 点赞

若觉得本文不错,就分享一下吧!

评论

作者其他优质文章

正在加载中
  • 推荐
  • 评论
  • 收藏
  • 共同学习,写下你的评论
感谢您的支持,我会继续努力的~
扫码打赏,你说多少就多少
赞赏金额会直接到老师账户
支付方式
打开微信扫一扫,即可进行扫码打赏哦
今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与 放弃机会
意见反馈 帮助中心 APP下载
官方微信

举报

0/150
提交
取消